/**
 * IBannerService
 *
 * 主要职责：
 * - 轮播图管理、状态与排序
 *
 * 实现关注点：
 * - 图片上传（Minio）、排序事务、缓存策略
 *
 * 答辩要点：
 * - 排序操作的原子性与并发控制
 */
package net.zjitc.yqmusicserver.service;

import com.baomidou.mybatisplus.extension.service.IService;
import net.zjitc.yqmusicserver.domain.Banner;
import net.zjitc.yqmusicserver.domain.dto.BannerDTO;
import net.zjitc.yqmusicserver.domain.vo.BannerVO;
import net.zjitc.yqmusicserver.result.PageResult;
import net.zjitc.yqmusicserver.result.Result;

import java.util.List;

/**
 * <p>
 * 服务类
 * </p>
 *
 * @author 罗翼侨
 * @since 2025/6/18 10:19
 */
public interface IBannerService extends IService<Banner> {

    // 获取轮播图列表
    Result<PageResult<Banner>> getAllBanners(BannerDTO bannerDTO);

    // 添加轮播图
    Result addBanner(String bannerUrl);

    // 更新轮播图
    Result updateBanner(Long bannerId, String bannerUrl);

    // 更新轮播图状态
    Result updateBannerStatus(Long bannerId, Integer bannerStatus);

    // 删除轮播图
    Result deleteBanner(Long bannerId);

    // 批量删除轮播图
    Result deleteBanners(List<Long> bannerIds);

    // 获取轮播图列表（用户端）
    Result<List<BannerVO>> getBannerList();
}
